package com.ruoyi.quanzi.mapper;

import java.util.List;
import com.ruoyi.quanzi.domain.SunPostCollection;
import org.apache.ibatis.annotations.Param;

/**
 * 帖子收藏Mapper接口
 * 
 * @author ruoyi
 * @date 2024-12-19
 */
public interface SunPostCollectionMapper 
{
    /**
     * 查询帖子收藏
     * 
     * @param id 帖子收藏主键
     * @return 帖子收藏
     */
    public SunPostCollection selectSunPostCollectionById(Long id);

    /**
     * 查询帖子收藏列表
     * 
     * @param sunPostCollection 帖子收藏
     * @return 帖子收藏集合
     */
    public List<SunPostCollection> selectSunPostCollectionList(SunPostCollection sunPostCollection);

    /**
     * 根据帖子ID和用户ID查询收藏记录
     * 
     * @param postId 帖子ID
     * @param uid 用户ID
     * @return 收藏记录
     */
    public SunPostCollection selectCollectionByPostAndUser(@Param("postId") Long postId, @Param("uid") Long uid);

    /**
     * 查询帖子的收藏用户列表
     * 
     * @param postId 帖子ID
     * @param limit 限制数量
     * @return 收藏记录列表
     */
    public List<SunPostCollection> selectPostCollectionUsers(@Param("postId") Long postId, @Param("limit") Integer limit);

    /**
     * 查询用户收藏的帖子列表
     * 
     * @param uid 用户ID
     * @param limit 限制数量
     * @return 收藏记录列表
     */
    public List<SunPostCollection> selectUserCollectionPosts(@Param("uid") Long uid, @Param("limit") Integer limit);

    /**
     * 统计帖子收藏数量
     * 
     * @param postId 帖子ID
     * @return 收藏数量
     */
    public int countPostCollections(@Param("postId") Long postId);

    /**
     * 统计用户收藏数量
     * 
     * @param uid 用户ID
     * @return 收藏数量
     */
    public int countUserCollections(@Param("uid") Long uid);

    /**
     * 检查用户是否已收藏
     * 
     * @param postId 帖子ID
     * @param uid 用户ID
     * @return 是否已收藏
     */
    public boolean checkUserCollected(@Param("postId") Long postId, @Param("uid") Long uid);

    /**
     * 新增帖子收藏
     * 
     * @param sunPostCollection 帖子收藏
     * @return 结果
     */
    public int insertSunPostCollection(SunPostCollection sunPostCollection);

    /**
     * 修改帖子收藏
     * 
     * @param sunPostCollection 帖子收藏
     * @return 结果
     */
    public int updateSunPostCollection(SunPostCollection sunPostCollection);

    /**
     * 删除帖子收藏
     * 
     * @param id 帖子收藏主键
     * @return 结果
     */
    public int deleteSunPostCollectionById(Long id);

    /**
     * 根据帖子ID和用户ID删除收藏记录
     * 
     * @param postId 帖子ID
     * @param uid 用户ID
     * @return 结果
     */
    public int deleteCollectionByPostAndUser(@Param("postId") Long postId, @Param("uid") Long uid);

    /**
    /**
     * 批量删除帖子收藏
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteSunPostCollectionByIds(Long[] ids);
    
    /**
     * 用户收藏帖子
     * 
     * @param userId 用户ID
     * @param postId 帖子ID
     * @return 结果
     */
    public int collectPost(@Param("userId") Long userId, @Param("postId") Long postId);
    
    /**
     * 用户取消收藏帖子
     * 
     * @param userId 用户ID
     * @param postId 帖子ID
     * @return 结果
     */
    public int uncollectPost(@Param("userId") Long userId, @Param("postId") Long postId);
    
    /**
     * 根据用户ID查询收藏列表
     * 
     * @param userId 用户ID
     * @return 收藏集合
     */
    public List<SunPostCollection> selectCollectionsByUserId(@Param("userId") Long userId);
    
    /**
     * 检查用户是否收藏了某个帖子
     * 
     * @param userId 用户ID
     * @param postId 帖子ID
     * @return 收藏数量
     */
    public int isPostCollectedByUser(@Param("userId") Long userId, @Param("postId") Long postId);
}
